home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / 4dmenu11.zip / 4DOSMENU.DOC < prev    next >
Text File  |  1991-11-22  |  7KB  |  186 lines
  1. Documentation for 4DOSMENU    version 1.1          22-Nov-91
  2. Copyright (C) 1991 Ted Harper
  3.  
  4.  
  5. Free distribution and use of BTM code and associated data files for
  6. _non-commercial_ purposes expressly permitted. This means that you can
  7. change them around all you like for your own purposes, but may NOT
  8. incorporate them in a commercial product, or charge for the
  9. customisation or installation of the menu system, or render the code in
  10. a commercially-sold book or other work (whether in original or modified
  11. form).
  12.  
  13. The program is _not_ guaranteed to do anything at all, except take up
  14. disk space. If it works, then I am happy for you; if you break it, you
  15. have both pieces!
  16.  
  17.  
  18. Introduction
  19. ------------
  20.  
  21. 4DOSMENU was written as an answer to the plethora of menuing systems
  22. which are available for MS-DOS systems. I don't see why anyone should
  23. pay good money for something which can be whipped-up in a few hours. As
  24. a byproduct, 4DOSMENU is a good demonstration of what can be written
  25. using only 4DOS built-in commands.
  26.  
  27. The program requires 4DOS - a shareware replacement for MS-DOS's
  28. COMMAND.COM written by J.P. Software - version 4.0 or later. If you do
  29. not have this, it is available from most bulletin board systems, or
  30. wherever you obtained this program. 4DOSMENU has been tested on a 386
  31. with a VGA screen running MS-DOS 5.00 with 4DOS 4.00; I have no idea how
  32. it performs on other systems.
  33.  
  34. A feature of 4DOSMENU is that different application menus may be
  35. presented to different "levels" of users. For example, you may want to
  36. allow everyone access to your word processing and spreadsheet programs,
  37. but not to your Pascal or C compilers. This division by access level is
  38. easily modified by changing a simple text file (not even the BTM
  39. itself).
  40.  
  41. A total of 62 different access levels are available, as numbers and
  42. upper and lower case alphas are used. The heirarchy used is
  43. [0(highest)..9,A..Z,a..z(lowest)]. A user at any given level can select
  44. options for their access level and those for all lower levels.
  45.  
  46.  
  47. Installing and Running 4DOSMENU
  48. -------------------------------
  49.  
  50. Copy the contents of the distribution archive into a directory (C:\ is
  51. probably as good a place as any). A couple of changes will need to be
  52. made to 4DOSMENU.BTM before you can run it :
  53.  
  54.         - Change the value of "curdir" to the directory where
  55.           4DOSMENU.BTM and FULLMENU.TXT have been put.
  56.  
  57.         - Change the value of "drivelist" to list the hard, floppy
  58.           and virtual (RAMdisk) drives you have on your machine,
  59.           whether locally connected, or accessible through a LAN.
  60.  
  61. Run 4DOSMENU from the command line by entering :
  62.  
  63. C:\>4DOSMENU 0<enter>
  64.  
  65. You should see system information and my sample application menu appear.
  66. Try using some different values for the user access level (replace the
  67. zero on the command line with E, P, R and z) to see the different menus
  68. users on my PC get.
  69.  
  70. To select menu choices, you move the cursor with the arrow keys, then
  71. hit <enter> on the choice you want. Probably the only options which will
  72. work "straight out of the box" are REFRESH and DOS - selecting anything
  73. else will probably result in an error message of some sort. The
  74. following section explains how to set 4DOSMENU up for your particular
  75. applications.
  76.  
  77.  
  78. Customising 4DOSMENU
  79. --------------------
  80.  
  81. Clearly, there is very little chance that many of the supplied menu
  82. commands will actually _work_ on systems other than mine <grin>. To
  83. modify the menu choices and actions, you need to do the following.
  84.  
  85. The FULLMENU.TXT file contains one line for each possible menu choice.
  86. The format of each line is as follows :-
  87.  
  88. L APPLNAME - Sensible description of the application
  89.  
  90. Where "L" is the minimum access level required to be able to use the
  91. application, "APPLNAME" is a meaningful short name for the application
  92. (_one_word_) of 8 characters or less in length, and the description that
  93. follows the "-" can be anything you like (up to about 35 characters).
  94.  
  95. For each APPLNAME specified in FULLMENU.TXT, there _must_ be a
  96. corresponding label in 4DOSMENU.BTM, followed by the code to actually
  97. run the application, then a jump back to the top of the menu loop.
  98.  
  99. As an example, let's add an option to run the "QEdit" text editor. I
  100. only want users of level "P" or higher to have access to this. For the
  101. sake of the exercise, I'll assume the executable for Qedit is in
  102. C:\QEDIT.
  103.  
  104. In the FULLMENU.TXT file (anywhere you like, but I normally keep things
  105. alphabetical), enter the following line :
  106.  
  107. P QEDIT    - Qedit text editor (v2.15)
  108.  
  109. In the 4DOSMENU.BTM file, in the part where the other applications are
  110. run, enter the following block of BTM code :
  111.  
  112. :QEDIT
  113.    cdd c:\qedit
  114.    q
  115.    goto loopback
  116.  
  117. That's all there is to it! You can try this out by running 4DOSMENU P
  118. (or any access level higher than P) and selecting the QEDIT option. The
  119. editor should run, and when you quit from it, you should be returned
  120. to 4DOSMENU.
  121.  
  122.  
  123. Hints
  124. -----
  125.  
  126. I always leave the "logoff", "park hard disk" and "refresh screen
  127. display" options as needing the lowest possible access level ("z"), to
  128. ensure everyone can get them. Functions which can seriously wipe you out
  129. should be set to the highest possible access level ("0"). In between
  130. these extremes, I only use three access levels :
  131.  
  132.         R - "Regular" users (my wife and her friends, who only really
  133.             use the word processor)
  134.  
  135.         P - "Privileged" users (other people who are allowed to use
  136.             other application programs and games)
  137.  
  138.         E - "Expert" users (who have access to various compilers and
  139.             other things best tightly controlled)
  140.  
  141. To make the display come up more quickly, limit the drives which are
  142. scanned by changing the "drivelist" variable to process only local
  143. hard and virtual drives (omit floppy and network drives).
  144.  
  145.  
  146. Payment, Support and Feedback
  147. -----------------------------
  148.  
  149. I am not requesting monetary payment for usage of 4DOSMENU. I would,
  150. however, appreciate some sort of acknowledgement and feedback from
  151. people using the program. Here is what I'd like :-
  152.  
  153. Send me a postcard or photograph of a nice scene in your area, with a
  154. brief note giving your name (and if you like EMail or "snail mail"
  155. address) on the back. Comments and suggestions for improvements to the
  156. program are welcomed. If you live near a ski resort, a pocket trail map
  157. or mountain guide would be even more gladly received!
  158.  
  159. My address is :        Ted Harper
  160.                        P.O. Box 105
  161.                        Baulkham Hills NSW 2153
  162.                        AUSTRALIA
  163.  
  164. If at any time you have any suggestions for improving the operation of
  165. 4DOSMENU, or find a <wince shudder> bug, drop me a message either by snail
  166. mail at the address above, or electronically at the bulletin board below
  167. (I'm co-sysop there) :-
  168.  
  169.        The Big Apple BBS
  170.        Sydney, Australia
  171.        GTNet 302/021
  172.        Phone +61 2 764-3410
  173.        24 hours / 7 days
  174.        Speeds 1200-9600(v32) / MNP 4 & 5
  175.  
  176.  
  177. ted harper
  178. 22-Nov-91
  179.  
  180.  
  181. Release History
  182. ---------------
  183. 1.0   17/11/91    Initial release.
  184. 1.1   22/11/91    Removed several non-standard aliases from BTM file.
  185.                   Added several more choices to sample menu.
  186.